---
title: EntityMoveManager 实体移动管理器
icon: Move
relatedFile: app/src/core/stage/stageManager/concreteMethods/StageEntityMoveManager.tsx
---

实体移动管理服务

该服务主要负责管理项目中实体的移动操作，包括用户拖动、对齐引起的移动，以及移动对所属区域（Section）大小的影响。未来可能还会支持自动布局功能。

## API

### `moveEntityUtils(entity: Entity, delta: Vector, isAutoAdjustSection: boolean)`

使单个实体移动一小段距离。可选择是否触发所属区域的弹性调整。

### `jumpMoveEntityUtils(entity: Entity, delta: Vector)`

使传入的实体进行跳跃式移动。此操作可能会破坏实体的嵌套关系，并伴随视觉特效。

### `moveEntityToUtils(entity: Entity, location: Vector)`

将某个实体移动到指定的目标位置。

### `moveSelectedEntities(delta: Vector, isAutoAdjustSection: boolean)`

使所有当前选中的实体移动一小段距离。可选择是否触发所属区域的弹性调整。

### `jumpMoveSelectedConnectableEntities(delta: Vector)`

使所有选中的可连接实体进行跳跃式移动。此操作可能会破坏区域的嵌套关系。

### `moveConnectableEntitiesWithChildren(delta: Vector)`

以树形结构移动所有选中的可连接实体，即同时移动实体及其所有子孙实体。

### `moveWithChildren(node: ConnectableEntity, delta: Vector)`

对传入的可连接实体及其所有子孙实体进行树形移动。
